---
image: /generated/articles-docs-cli-benchmark.png
title: npx remotion benchmark
sidebar_label: benchmark
crumb: CLI Reference
---

_available from v3.2.28_

Measures render time by running a render multiple times, if desired with multiple compositions and concurrency values to compare against each other.

```bash
npx remotion benchmark src/index.ts [composition-ids]
```

You can provide multiple composition IDs separated by comma, ex: `npx remotion benchmark src/index.ts --codec=h264 Main,Canvas,CSS`

If `composition-ids` is not passed, Remotion will let you select compositions from a list.

## Flags

### `--runs`

_optional. Default is 3_

Specify how many times video must be rendered. Default value is 3.

### `--concurrencies`

_optional_

You can specify which concurrency value should be used while rendering the video. Multiple concurrency values can be passed separated by comma. Learn more about [concurrency](/docs/terminology/concurrency)

### `--codec`

_optional_

Inherited from [`npx remotion render`](/docs/cli/render#--codec)

### `--audio-codec`<AvailableFrom v="3.3.42" />

_optional_

<Options id="audio-codec" />

### `--crf`

_optional_

Inherited from [`npx remotion render`](/docs/cli/render#--crf)

### `--frames`

_optional_

Inherited from [`npx remotion render`](/docs/cli/render#--frames)

### `--image-format`

_optional_

Inherited from [`npx remotion render`](/docs/cli/render#--image-format)

### `--pixel-format`

_optional_

Inherited from [`npx remotion render`](/docs/cli/render#--pixel-format)

### `--props`

_optional_

Inherited from [`npx remotion render`](/docs/cli/render#--props)

### `--prores-profile`

_optional_

Inherited from [`npx remotion render`](/docs/cli/render#--prores-profile)

### `--jpeg-quality`

_optional, available from v4.0.0_

Inherited from [`npx remotion render`](/docs/cli/render#--jpeg-quality)

### ~~`--quality`~~

_optional, removed in v4.0.0_

Renamed to `--jpeg-quality`.

### `--log`

_optional_

Inherited from [`npx remotion render`](/docs/cli/render#--log)

### `--ignore-certificate-errors`

_optional_

Inherited from [`npx remotion render`](/docs/cli/render#--ignore-certificate-errors)

### `--disable-web-security`

_optional_

Inherited from [`npx remotion render`](/docs/cli/render#--disable-web-security)

### `--dark-mode`<AvailableFrom v="4.0.381"/>

<Options id="dark-mode" />

### ~`--disable-headless?`~

_optional_

<Options id="disable-headless" />

### `--enable-multiprocess-on-linux`<AvailableFrom v="4.0.42"/>

<Options cli id="enable-multiprocess-on-linux" />

### `--gl`

_optional_

Inherited from [`npx remotion render`](/docs/cli/render#--gl)

### `--chrome-mode`<AvailableFrom v="4.0.248" />

<Options id="chrome-mode" />

### `--timeout`

_optional_

Inherited from [`npx remotion render`](/docs/cli/render#--timeout)

### `--scale`

_optional_

Inherited from [`npx remotion render`](/docs/cli/render#--scale)

### `--port`

_optional_

Inherited from [`npx remotion render`](/docs/cli/render#--port)

### `--number-of-gif-loops`

_optional_

<Options id="number-of-gif-loops" />

### `--every-nth-frame`

_optional_

Inherited from [`npx remotion render`](/docs/cli/render#--every-nth-frame)

### `--log`

_optional_

Inherited from [`npx remotion render`](/docs/cli/render#--log)

### `--muted`

_optional_

Inherited from [`npx remotion render`](/docs/cli/render#--muted)

### `--enforce-audio-track`

_optional_

Inherited from [`npx remotion render`](/docs/cli/render#--enforce-audio-track)

### `--disallow-parallel-encoding`<AvailableFrom v="4.0.315" />

_optional_

Inherited from [`npx remotion render`](/docs/cli/render#--disallow-parallel-encoding)

### `--browser-executable`

_optional_

Inherited from [`npx remotion render`](/docs/cli/render#--browser-executable)

### `--public-dir`

_optional_

Inherited from [`npx remotion render`](/docs/cli/render#--public-dir)

### `--config`

_optional_

Inherited from [`npx remotion render`](/docs/cli/render#--config)

### `--bundle-cache`

_optional_

Inherited from [`npx remotion render`](/docs/cli/render#--bundle-cache)

### `--video-bitrate`

_optional_

Inherited from [`npx remotion render`](/docs/cli/render#--video-bitrate)

### `--audio-bitrate`

_optional_

Inherited from [`npx remotion render`](/docs/cli/render#--audio-bitrate)

### `--color-space`<AvailableFrom v="4.0.28"/>

<Options cli id="color-space" />

### `--hardware-acceleration`<AvailableFrom v="4.0.228" />

<Options cli id="hardware-acceleration" />

### `--offthreadvideo-cache-size-in-bytes`<AvailableFrom v="4.0.23"/>

<Options id="offthreadvideo-cache-size-in-bytes" />

### `--media-cache-size-in-bytes`<AvailableFrom v="4.0.352"/>

<Options id="media-cache-size-in-bytes" />

### `--binaries-directory`<AvailableFrom v="4.0.120" />

<Options cli id="binaries-directory" />

### ~~`--ffmpeg-executable`~~

_optional, removed in v4.0_

Inherited from [`npx remotion render`](/docs/cli/render#--ffmpeg-executable)

### ~~`--ffprobe-executable`~~

_optional, removed in v4.0_

Inherited from [`npx remotion render`](/docs/cli/render#--ffprobe-executable-)
